home *** CD-ROM | disk | FTP | other *** search
/ Aminet 41 / Aminet 41 (2001)(Schatztruhe)[!][Feb 2001].iso / Aminet / dev / c / Emperor_v3.5.readme < prev    next >
Encoding:
Text File  |  2000-12-20  |  16.2 KB  |  330 lines
  1. Short:    Object-oriented programming language
  2. Author:   Matthias Gietzelt
  3. Uploader: Andreas Gietzelt <endee@t-online.de>
  4. Version:  3.5
  5. Type:     dev/c
  6. Email:    <joachim.gietzelt@klinikum-sn.de>
  7. Requires: OS 3.5, well-equipped Amiga, some knowledge,
  8.  
  9.           Amiga Developer CD 2.1 (see below)
  10.  
  11.  
  12.         _______   __   __          ___        _______   ___      ___          ___   
  13.        /******/  /**| /**|        /***\      /******/  /***\    /***\        /***\  
  14.       /**____/  /***|/***|       /*__**\    /**____/  /*__**\  /*___*\      /*__**\ 
  15.      /**/___   /*/ |**/|*|      /*/__/*|   /**/___   /*/__/*| |*/   \*|    /*/__/*| 
  16.     /******/  /*/  |_/ |*|     /*******/  /******/  /*******/ |*|   |*|   /*******/ 
  17.    /**____/  /*/       |*|    /*______/  /**____/  /*__**__/  |*|   |*|  /*__**__/  
  18.   /**/___   /*/        |*|   /*/        /**/___   /*/  \*\    \*\___/*/ /*/  \*\    
  19.  /******/  /*/         |*|  /*/        /******/  /*/    \*\    \*****/ /*/    \*\   
  20. /______/  /_/          |_| /_/        /______/  /_/      \_\    \___/ /_/      \_\  
  21.  
  22.  
  23.                       The object-oriented programming language
  24.  
  25.                     Available at www.aminet.de ! (Drawer: dev/c)
  26.  
  27.  
  28.  
  29. Für die deutsche Version, bitte weiter unten lesen....
  30.  
  31.  
  32. ENGLISH:
  33.  
  34.  
  35. History
  36.  
  37. 2.0  - Initial release
  38. ---
  39. 2.1  - GadTools gadgets support !!
  40.      - reached to shrink programsize by coding the window-stuff by myself
  41.        instead of making it by ReActor
  42. ---
  43. 2.2  - Oops..The program crashed, when a clicktab was in a test-window.
  44.      - speed optimizations (e.g. at startup, shutdown etc.)
  45.      - defined catalog-creation
  46.      - C++-Code support
  47.      - added the macro "Preferences-Menu" for Prefs-Programs
  48.      - better & easier generated C-sourcecode
  49.      - minor bugfixes
  50. ---
  51. 2.3  - prefs-editor rewritten
  52.      - chooseable processortype for generated StormC-project
  53.      - modified programming-help
  54.      - some functionmacros rewritten
  55.      - minor bugfixes
  56. ---
  57. 3.0  - gadgets-test routine rewritten
  58.      - fixed bugs by showing tapedeck & colorwheel gadgets
  59.      - fixed problems with clicktabs & page gadgets (see "clicktabsexample")
  60.      - added function "Shutdown()" (called, when program quits)
  61.      - added progress-bar while saving
  62.      - added macrofunctions "Emperor_Set/GetGadgetAttrComplex()"
  63.        (see guide for details)
  64. ---
  65. 3.1  - fixed a bug when generating source for window with colorwheel
  66.      - source is now *more* SAS/C friendly
  67.      - fixed a silly bug when copy a function from programming help into texteditor
  68.      - added online help for macrofunctions (see chapter Programming Help for details)
  69.      - added ARexx-connection to StormC (Scripts - Dir)
  70.      - added arguments by starting StormC (e.g. GoldED support for StormC)
  71.      - added loading picture
  72. ---
  73. 3.2  - added parametry of several image-gadgets (bevel, bitmap, glyph)
  74.        (see "ClicktabExample" for details)
  75.      - fixed a bug with slider and getfile-gadgets
  76.      - fixed problem with requester-body-text ["\n" (Newline) will be recognized now]
  77.      - rewritten routine for adding, moving (up and down) and removing of objects in a list
  78. ---
  79. 3.5  - showing of scroller & slider-gadgets fixed
  80.      - layout-gadget (bevelstyle & -state) doesn't switch back to previous setted
  81.        values anymore
  82.      - added support of finnish catalog
  83.      - added program-environment for configuration of version, program name,
  84.        stack, mem and many more
  85.      - deleting windows is possible now
  86.      - when pages were added to gadgetlist, its generation was incorrect
  87.      - added gadgethelp support - just connect a gadget to configure ! (program-environment)
  88.      - added function <Menu-Edit-Clearlist> to reset current list of objects
  89.      - label's Locale-connection works correct now
  90.      - gadgethelp for nearly every gadget
  91.      - added chooseable HookType for string-gadgets
  92.      - added some initial-configurations for texteditor-gadgets
  93.      - moving Locale-entrys is possible now
  94.      - editing the includelist is also possible now
  95.      - added new startup-picture (thanks to Janne Peräaho)
  96.  
  97.  
  98. Introduction
  99.  
  100. Thanks for decrunching and the will to testing the program-packet.
  101. This program is for "revolutioning" the software-development on Amiga.
  102.  
  103. Object-oriented programminglanguage (OOP) is maybe a bit too high for that
  104. program, because there are "real" C/C++-sourcecodes generated and
  105. an external C/C++-Compiler must translate it into machine-code. In the Amiga-sphere
  106. there are only less applications like CanDo, Storm-Wizard and so on, but one day
  107. I have seen the program "Delphi" on the PC :( ! This OOP is exclusive controlable
  108. in Pascal (that set's me up) and it has millions of configuration-possibilities.
  109. I didn't knew such things on Amiga, and so I made it by myself.
  110.  
  111. I want to make parameting of the Graphical User Interface (GUI) and its macro-elements as easy as
  112. possible. Following standard-GUI-elements are implemented:
  113.  * Windows
  114.  * OS2.0 Gadgets (GadTools)
  115.  * OS3.5 Gadgets (Reaction)
  116.  * Requests
  117.  * Menus
  118.  * ASL-Requests
  119.  * Locale
  120.  * Function-macros, which makes programming under OS3.5 more easily
  121.  
  122. With Emperor you are generating a complete C/C++-sourcecode, which only must be
  123. compiled by an external compiler (e.g. StormC from the developer CD2.1).
  124.  
  125. Aim of this program is to assure software developer to create their programs (its sourcecode)
  126. by Emperor, because the making of software (opening of windows, file- and fontrequests,
  127. menus etc.) is often equal and must not longer copied by programmers from other sourcecodes.
  128. Emperor decrees about one or more macros for every GUI-element. Like the menus:
  129. here you must, for creating the complete Project-menu (open, close, save, print etc.) and its
  130. translation, (in Locale-".catalog"-file) only select the corresponding entry in the list.
  131. This is also possible with requests e.g. by making a QuitRequest. These are called in
  132. the own sourcecode as function "REQUESTNAME();".
  133.  
  134. But the program should also be for user, who never programmed before,
  135. and bade an easy way in the programming of AmigaOS-GUIs.
  136.  
  137.  
  138. Systemrequirements
  139.  
  140.   - an Amiga ;-)
  141.   - Memory at least 24 MByte !!; recommended 64 MByte or more
  142.   - Workbench version 3.5 or higher
  143.   - Processor at least 68020; recommended 68060
  144.   - Amiga Developer CD 2.1 of the HAAGE & Partner GmbH
  145.   - C/C++-Compiler (from the developer CD "ADCD_2.1:Contributions/Haage_&_Partner/StormC/")
  146.   - CatComp (from the developer CD "ADCD_2.1:NDK/NDK_3.5/Tools/CatComp")
  147.   - xen.font in size 8 installed in "Fonts:"-directory of the Bootdevice, :-)
  148.  
  149.  
  150. DEUTSCH:
  151.  
  152.  
  153. Die Geschichte
  154.  
  155. 2.0  - Erste Veröffentlichung
  156. ---
  157. 2.1  - AmigaOS 2.0 Gadgets hinzugefügt !!
  158.        (GadTools-Gadgets sind nun verfügbar !)
  159.      - Programm ist durch Code-Umsetzung von ReActor nach eigenem Code geschrumpft.
  160. ---
  161. 2.2  - Programmabsturz, wenn Clicktab-Gadgets in einem Test-Fenster waren.
  162.      - Geschwindigkeitsoptimierungen (z.B. beim Start, Ende etc.)
  163.      - definierte Catalog-Erstellung
  164.      - Makro "Preferences-Menü" für Einstellungs-Programme
  165.      - C++-Quelltext Unterstützung
  166.      - besserer & einfacherer generierter C-Quelltext
  167.      - minimale Fehler behoben
  168. ---
  169. 2.3  - Prefs-Editor überarbeitet
  170.      - wählbarer Prozessortyp für generierten StormC-Projekt
  171.      - modifizierte Programmierhilfe
  172.      - diverse Funktionsmakros überarbeitet
  173.      - minimale Fehler behoben
  174. ---
  175. 3.0  - Gadget-Test Routine überarbeitet
  176.      - Fehler beim Anzeigen von Tapedeck & Colorwheel Gadgets behoben
  177.      - Probleme mit Clicktabs & Page Gadgets behoben (siehe "clicktabsexample")
  178.      - Funktion "Shutdown()" hinzugefügt (Aufruf, bei Programmende)
  179.      - Fortschrittsanzeige während des Speicherns
  180.      - Makrofunktion "Emperor_Set/GetGadgetAttrComplex()" hinzugefügt
  181.        (siehe Emperor.guide)
  182. ---
  183. 3.1  - Fehler beim Quelltextgenerieren mit ColorWheels behoben
  184.      - Quelltext ist nun SAS/C freundlich*er*
  185.      - Fehler beim Kopieren einer Funktion von der Programmierhilfe in den Texteditor behoben
  186.      - Online Hilfe für Makrofunktionen hinzugefügt (siehe Kapitel Programmierhilfe)
  187.      - ARexx-Verbindung zu StormC (Scripts - Verzeichnis)
  188.      - Argumente beim Starten von StormC hinzugefügt (z.B. GoldED support für StormC)
  189.      - Ladebild hinzugefügt
  190. ---
  191. 3.2  - diverse Image-Gadgets (Bevel, Bitmap, Glyph) hinzugefügt
  192.        (siehe "ClicktabExample" für Einzelheiten)
  193.      - Fehler mit Slider und Getfile-Gadgets behoben
  194.      - Problem mit dem Requester-Body-Text behoben ["\n" (Newline) wird nun berücksichtigt]
  195.      - Routine für hinzufügen, verschieben (hoch und runter) und löschen von Objekten
  196.        in den Listen überarbeitet
  197. ---
  198. 3.5  - Anzeigen des Scroller & Slider-Gadgets ist überarbeitet worden
  199.      - Layout-Gadget (BevelStyle & -State) springt nicht mehr zu zuvor eingestellten
  200.        Werten zurück
  201.      - Finnischen Katalog hinzugefügt
  202.      - Programmumgebung zur Konfiguration von Version, Programmnamen, Stack, Speicher
  203.        und vielem, vielem mehr hinzugefügt
  204.      - löschen von Fenstern ist nun möglich
  205.      - wenn Pages hinzugefügt wurden, waren deren Generationen inkorrekt
  206.      - GadgetHelp hinzugefügt - einfach ein Gadget verbinden, um die GadgetHelp zu
  207.        konfigurieren ! (Programmumgebung)
  208.      - Funktion <Menü-Bearbeiten-Liste löschen> für das Zurücksetzen der aktiven Liste von
  209.        Objekten hinzugefügt
  210.      - Label's Locale-Verbindung arbeitet nun korrekt
  211.      - GadgetHelp für beinahe jedes Gadget
  212.      - wählbarer HookType für String-Gadgets
  213.      - diverse Initial-konfigurationen für Texteditor-Gadgets hinzugefügt
  214.      - verschieben von Locale-Einträgen ist nun möglich
  215.      - editieren der Includeliste ist nun möglich
  216.      - neues Startupbild hinzugefügt (Dank an Janne Peräaho)
  217.  
  218.  
  219. Die Einführung
  220.  
  221. Vielen Dank, daß Sie dieses Programm entpackt haben und ausprobieren möchten !
  222. Dieses Programm soll die Software-Entwicklung auf dem Amiga "revolutionieren".
  223.  
  224. Objekt-orientierte Programmiersprache (OOP) ist vielleicht ein wenig
  225. zu hoch gegriffen, da weiterhin "echte" C/C++-Quelltexte generiert und
  226. durch einen externen C/C++-Compiler übersetzt werden müssen. Im Amiga-Bereich
  227. gibt's nur wenige Ausnahmen wie CanDo, Storm-Wizard u.a., aber irgendwann habe
  228. ich das Programm "Delphi" auf dem PC :( kennengelernt ! Diese OOP ist
  229. ausschließlich in Pascal gehalten (was mich arg störte) und erschlägt einen
  230. mit den Millionen Konfigurations-möglichkeiten. Ich kannte soetwas in der Art
  231. bisher auf dem Amiga nicht, und kurzentschlossen setzte ich mich selbst daran.
  232.  
  233. Ich wollte die Parametrierung der Oberfläche und der Makro-Elemente so einfach wie
  234. möglich machen. Folgende Standard-Oberflächenelemente sind implementiert:
  235.  * Fenster
  236.  * OS2.0 Gadgets (GadTools)
  237.  * OS3.5 Gadgets (Reaction)
  238.  * Requester
  239.  * Menüs
  240.  * ASL-Requester
  241.  * Locale
  242.  * vorgefertigte Funktionsmakros, die das Programmieren unter OS3.5 wesentlich erleichtern.
  243.  
  244. Man generiert mit Emperor einen komplett fertigen C/C++-Quelltext, der nur noch
  245. durch einen externen Compiler (z.B. StormC auf der Developer CD2.1) übersetzt werden muß.
  246.  
  247. Ziel dieses Programms soll sein, Softwareentwickler zu überzeugen mit Emperor ihre
  248. Programme (deren Quelltext) zu erstellen, da die Verfahrensweise bei der Erstellung
  249. von Software (Öffnen von Fenstern, Datei- und Schriftauswahlrequestern, Menüs etc.)
  250. oft gleich ist und nicht weiter durch den Programmierer selbst mühsam aus anderen
  251. Quelltexten herausgefischt werden muß. Emperor verfügt für jedes Element schon
  252. ein oder mehrere vorgefertigte, aber veränderbare, Makros. So z.B. bei den Menüs:
  253. hier muß für das Projekt-Menü (Öffnen, Speichern, Drucken etc.) und dessen
  254. Übersetzung (für Locale - ".catalog"-Datei) nur der entsprechende Eintrag
  255. gewählt werden. Dies gilt auch für Requester z.B. für das QuitRequest. Diese müssen
  256. nur noch im eigenen Quelltext als Funktion "REQUESTERNAME();" aufgerufen werden.
  257.  
  258. Das Programm soll aber auch für Amigianer sein, die noch nie programmiert haben,
  259. und so einen einfachen Einstieg in die Programmierung der AmigaOS-Oberfläche bieten.
  260.  
  261.  
  262. Die Systemanforderungen
  263.  
  264.   - einen Amiga ;-)
  265.   - Speicher mindestens 24 MByte !!; empfohlen 64 MByte oder mehr
  266.   - Workbench Version 3.5 oder höher
  267.   - Prozessor mindestens 68020; empfohlen 68060
  268.   - Amiga Developer CD 2.1 von der HAAGE & Partner GmbH
  269.   - C/C++-Compiler (von der Developer CD "ADCD_2.1:Contributions/Haage_&_Partner/StormC/")
  270.   - CatComp (von der Developer CD "ADCD_2.1:NDK/NDK_3.5/Tools/CatComp")
  271.   - xen.font in der Größe 8 im "Fonts:"-Verzeichnis des Bootlaufwerks, :-)
  272.  
  273.  
  274. ============================= Archive contents =============================
  275.  
  276. Original  Packed Ratio    Date     Time    Name
  277. -------- ------- ----- --------- --------  -------------
  278.     1892    1031 45.5% 17-Dec-00 18:06:36  Emperor/Emperor.prefs.info
  279.     1362     997 26.7% 18-Dec-00 12:53:02  Emperor/Emperor.readme.info
  280.     1362     999 26.6% 18-Dec-00 12:40:56  Emperor/Emperor_deutsch.guide.info
  281.     1362     999 26.6% 18-Dec-00 12:40:56  Emperor/Emperor_english.guide.info
  282.     1558     840 46.0% 17-Dec-00 18:05:36  Emperor/Projects.info
  283.    43928   16733 61.9% 17-Dec-00 21:54:42  Emperor/Projects/AminetSearcher
  284.     2904     971 66.5% 17-Dec-00 21:54:42  Emperor/Projects/Catalogs/deutsch/AminetSearcher.catalog
  285.      192     141 26.5% 17-Dec-00 21:54:42  Emperor/Projects/Catalogs/deutsch/ClicktabExample.catalog
  286.      560     339 39.4% 17-Dec-00 21:54:42  Emperor/Projects/Catalogs/deutsch/DevsManager.catalog
  287.   155662   13480 91.3% 17-Dec-00 21:54:42  Emperor/Projects/AminetSearcher.c
  288.     3616     988 72.6% 17-Dec-00 21:54:42  Emperor/Projects/AminetSearcher.cd
  289.    21440    2949 86.2% 17-Dec-00 21:54:42  Emperor/Projects/AminetSearcher.h
  290.     1428     842 41.0% 17-Dec-00 21:54:42  Emperor/Projects/AminetSearcher.info
  291.    16731    3413 79.6% 17-Dec-00 21:54:42  Emperor/Projects/AminetSearcher.project
  292.     1159     488 57.8% 17-Dec-00 21:54:42  Emperor/Projects/AminetSearcher.¶
  293.     5640    1573 72.1% 17-Dec-00 21:54:42  Emperor/Projects/AminetSearcher_deutsch.ct
  294.     3585     968 72.9% 17-Dec-00 21:54:42  Emperor/Projects/AminetSearcher_lowlevel.h
  295.    24004    9681 59.6% 17-Dec-00 21:54:42  Emperor/Projects/ClicktabExample
  296.      830     636 23.3% 18-Dec-00 12:53:58  Emperor/Projects/ClicktabExample.info
  297.   114182   10104 91.1% 17-Dec-00 21:54:42  Emperor/Projects/ClicktabExample.c
  298.      174     129 25.8% 17-Dec-00 21:54:42  Emperor/Projects/ClicktabExample.cd
  299.       69      69  0.0% 17-Dec-00 21:54:42  Emperor/Projects/ClicktabExample.h
  300.     9852    6359 35.4% 17-Dec-00 21:54:42  Emperor/Projects/ClicktabExample.iff
  301.    13569   13569  0.0% 17-Dec-00 21:54:42  Emperor/Projects/ClicktabExample.jpg
  302.     6609    1286 80.5% 17-Dec-00 21:54:42  Emperor/Projects/ClicktabExample.project
  303.     2284    1002 56.1% 17-Dec-00 21:54:42  Emperor/Projects/ClicktabExample.README!
  304.     1162     491 57.7% 17-Dec-00 21:54:42  Emperor/Projects/ClicktabExample.¶
  305.      253     185 26.8% 17-Dec-00 21:54:42  Emperor/Projects/ClicktabExample_deutsch.ct
  306.    29664   12400 58.1% 17-Dec-00 21:54:42  Emperor/Projects/DevsManager
  307.    49620   14639 70.4% 17-Dec-00 21:54:18  Emperor/Catalogs/deutsch/Emperor.catalog
  308.    68977   14608 78.8% 17-Dec-00 21:54:18  Emperor/Catalogs/Emperor.cd
  309.    54253   54253  0.0% 17-Dec-00 18:07:04  Emperor/Emperor.pic
  310.       76      58 23.6% 17-Dec-00 18:06:36  Emperor/Emperor.prefs
  311.    97298   10725 88.9% 17-Dec-00 21:54:44  Emperor/Projects/DevsManager.c
  312.      779     355 54.4% 17-Dec-00 21:54:44  Emperor/Projects/DevsManager.cd
  313.     7855    1403 82.1% 17-Dec-00 21:54:44  Emperor/Projects/DevsManager.h
  314.     1593     889 44.1% 17-Dec-00 21:54:42  Emperor/Projects/DevsManager.info
  315.     6844    1672 75.5% 17-Dec-00 21:54:44  Emperor/Projects/DevsManager.project
  316.     1150     488 57.5% 17-Dec-00 21:54:44  Emperor/Projects/DevsManager.¶
  317.     1080     524 51.4% 17-Dec-00 21:54:44  Emperor/Projects/DevsManager_deutsch.ct
  318.     1077     400 62.8% 17-Dec-00 18:07:16  Emperor/Scripts/stormc.rexx
  319.     1643    1167 28.9% 17-Dec-00 18:05:40  Emperor.info
  320.    13768    3283 76.1% 17-Dec-00 18:05:50  Emperor.install
  321.     1245     973 21.8% 17-Dec-00 18:05:50  Emperor.install.info
  322.     4838    1221 74.7% 18-Dec-00 12:40:54  Emperor/ClicktabExample.README!
  323.   978980  259350 73.5% 18-Dec-00 14:12:34  Emperor/Emperor
  324.     2692    1456 45.9% 18-Dec-00 14:12:34  Emperor/Emperor.info
  325.    12488    5079 59.3% 18-Dec-00 12:40:54  Emperor/Emperor.readme
  326.    79320   21191 73.2% 18-Dec-00 13:30:02  Emperor/Emperor_deutsch.guide
  327.    68834   17323 74.8% 18-Dec-00 13:30:16  Emperor/Emperor_english.guide
  328. -------- ------- ----- --------- --------
  329.  1921443  514719 73.2% 18-Dec-100 14:14:38   50 files
  330.